home *** CD-ROM | disk | FTP | other *** search
/ 500 MB Nyheder Direkte fra Internet 6 / 500 MB nyheder direkte fra internet CD 6.iso / start / progs / text / generate.txt < prev    next >
Text File  |  1995-07-18  |  47KB  |  842 lines

  1.            This is the instruction manual for HyperRead and
  2.         HyperRead Generator. It is also a demonstration HyperRead
  3.         file. You can flip through this document one page at a time
  4.         using the <PgUp> and <PgDn> keys. You can move one line at
  5.         a time by holding down the Ctrl key as you press <PgUp> or
  6.         <PgDn>. You can also move through the document by pressing
  7.         the up or down cursor key. If the screen cursor gets to the
  8.         top or bottom of the screen and you continue pressing the
  9.         cursor key, the text will scroll. You can move to the top
  10.         of the document by pressing the <Home> key on your
  11.         keyboard, or go to the end of the document by pressing the
  12.         <End> key.
  13.            You also can jump around in the document using the link
  14.         words or phrases. Link phrases look like this. To jump to a
  15.         section of text containing more information on a link
  16.         phrase, use the cursor keys to move the screen cursor to
  17.         the link phrase, then press the <J> key on the keyboard.
  18.         You may do this repeatedly, going from one link word to
  19.         another. You can backtrack along this path by pressing the
  20.         <B> key on the keyboard. There is more information on this
  21.         "jumping" later in this document.
  22.            You can also control HyperRead Generator using a mouse
  23.         if you have one installed. This will be explained later (or
  24.         you can jump to this subject now by jumping from the word
  25.         "mouse" and then backtracking to this page when you are
  26.         done).
  27.            You may now read the manual. Enjoy, and feel free to
  28.         experiment with the link phrases.
  29.  
  30.            Every few years, a new concept comes along that offers a
  31.         whole new use for personal computers. Typical examples have
  32.         been word processing, telecommunications and BBS's,
  33.         spreadsheets, and desktop publishing. The latest new idea
  34.         is hypertext.
  35.            What is hypertext? It is an indexing system that allows
  36.         people to use their computers to read computer text files
  37.         quickly and easily. It does this by allowing them to jump
  38.         from one part of the file to another, following whatever
  39.         train of thought they want.
  40.            In an ordinary printed document, the reader must read
  41.         the document linearly. That is, the person must read from
  42.         the beginning to the end, one page at a time. Sometimes the
  43.         person can jump around a little by using the index or the
  44.         table of contents, but this is very limited. The index can
  45.         only list a few key words, and the pages listed for those
  46.         words are usually simply where the word is defined or first
  47.         mentioned. The table of contents points only to broad areas
  48.         of the document where a general subject is discussed. In
  49.         any case, flipping through the pages is time-consuming and
  50.         tedious.
  51.            With hypertext, the author of a document can create
  52.         "tunnels" or links within a document that allow the reader
  53.         to jump from one area of the document to another. The
  54.         reader uses a computer to read the text on the screen. When
  55.         he or she finds an important word or phrase in the text
  56.         that needs clarifying, the computer can jump to the part of
  57.         the text that explains the term or gives more information.
  58.         For example, suppose you are reading a story about the
  59.         history of the electric light bulb. The story mentions that
  60.         it was invented by Thomas Edison. If you get curious about
  61.         Edison, you can jump directly from that part of the text to
  62.         the part that tells you more about Edison. That part of the
  63.         text might mention some of Edison's other inventions. If
  64.         you see one that looks interesting, you can jump directly
  65.         to the part of the text that describes this invention. This
  66.         can vastly increase the speed at which you can find
  67.         information.
  68.            HyperRead Generator and HyperRead are programs that
  69.         allow you to create and distribute hypertext documents.
  70.         HyperRead Generator allows you to convert an ordinary ASCII
  71.         text file into a hypertext document, which you may then use
  72.         or distribute. This program is shareware. It can be
  73.         downloaded from various Bulletin Board Systems or ordered
  74.         directly from Leithauser Research or a qualified
  75.         distributor. HyperRead is the program that allows you to
  76.         read the hypertext documents. This program is freeware, and
  77.         you may distribute it freely with any HyperRead files you
  78.         create. Both programs can be used with or without a mouse.
  79.            Before explaining how to use HyperRead Generator, an
  80.         explanation of how to operate HyperRead will be helpful.
  81.         This is partly because the person who reads the document
  82.         will be using HyperRead, so a thorough understanding of
  83.         HyperRead is important to anyone who plans to use
  84.         HyperRead Generator to create HyperRead files. It is also
  85.         helpful to understand HyperRead because HyperRead
  86.         Generator operates almost identically to HyperRead,
  87.         except that it has some extra functions and is missing a
  88.         few minor ones from HyperRead.
  89.  
  90.         Using HyperRead
  91.  
  92.            To read a HyperRead file, you need only run HyperRead
  93.         and load the desired HyperRead document. There are two ways
  94.         you can do this. You can simply type the program name (HR5)
  95.         at the DOS prompt. If there are more than one HyperRead
  96.         files in the current default directory, the computer will
  97.         then display a list of HyperRead files and ask you which
  98.         file to load (Otherwise it simply loads the one file). Type
  99.         the name of the file and press the ENTER key. Note: All
  100.         HyperRead documents actually consist of two files. There is
  101.         a text document file that can have any name and extension.
  102.         There is also a control file that has the extension HRF. It
  103.         is not necessary to type this extension to load the file.
  104.         For example, to load the file GENERATE.HRF, just enter the
  105.         name GENERATE.
  106.            Another way to run HyperRead and load a file is to type
  107.         the program name (HR5) followed by the name of the file to
  108.         load at the DOS prompt. For example, this file is called
  109.         GENERATE.HRF. You can run the program and load this file at
  110.         the same time by typing HR5 GENERATE at the DOS prompt (it
  111.         is not necessary to include the extension). This feature
  112.         makes it easy to create a batch file that automatically
  113.         runs the HyperRead program and loads a HyperRead file.
  114.            When the program has loaded the file, it will display
  115.         the first page of the file. At the bottom of the screen,
  116.         you will see a list of options. These options are PgUp,
  117.         Home, Help, Load, Quit, Jump, Backtrack, Search, Print,
  118.         End, and PgDn. For the PgUp, PgDn, Home, and End options,
  119.         press these keys on the keyboard. For the other options,
  120.         press the first letter of the option. These options are
  121.         explained below.
  122.  
  123.         PgDn
  124.  
  125.            Pressing the <PgDn> key moves the page of text on the
  126.         screen to the next page. That is, it scrolls down 23 lines.
  127.         If you hold down the <Ctrl> key while pressing the <PgDn>
  128.         key, however, the screen will scroll only one line.
  129.  
  130.         PgUp
  131.  
  132.            Pressing the <PgUp> key scrolls the text up 23 lines. If
  133.         you hold down the <Ctrl> key while pressing this key,
  134.         however, the text will scroll only one line.
  135.  
  136.         Home
  137.  
  138.            Pressing the <Home> key moves you directly to the first
  139.         page of the document. If you are in the middle of a long
  140.         document, this can be a faster way to get to the beginning
  141.         than repeatedly pressing <PgUp>.
  142.  
  143.         End
  144.  
  145.            Pressing the <End> key moves you to the last page of the
  146.         document. If you want to get to a page near the end, you
  147.         can press <End> and then <PgUp> a few times. This is
  148.         sometimes faster than pressing <PgDn> repeatedly.
  149.  
  150.         Cursor Keys
  151.  
  152.            You can move the screen cursor with the cursor keys and
  153.         also scroll through the document by moving beyond the top
  154.         or bottom of the screen.
  155.  
  156.         Help
  157.  
  158.            This option displays a Help screen. This screen gives a
  159.         short summary of the other options and how to use them.
  160.         After viewing this help screen, you can press the space bar
  161.         to return to the HyperRead document.
  162.  
  163.         Load
  164.  
  165.            This loads a document file into memory. The computer
  166.         will display a list of HyperRead documents in the current
  167.         directory. Type the name of the file and press ENTER. It is
  168.         not necessary to include the extension. This option allows
  169.         you to read several documents without returning to DOS to
  170.         reload HyperRead and load a new document.
  171.  
  172.         Quit
  173.  
  174.            This option ends the programs and returns you to DOS.
  175.  
  176.         Jump
  177.  
  178.            This is the function that allows you to move directly to
  179.         another area of the document that is pointed to by a link
  180.         word or phrase. If you have a color screen, the default color
  181.         for link words is blue on a black background. If you have a
  182.         monochrome screen, default color for link words is black on
  183.         a white background. You can change these at program startup.
  184.            To select a link word, use the keyboard cursor keys to
  185.         move the flashing screen cursor until it is somewhere on
  186.         the link word. Then press the <J> key. The computer will
  187.         then display the page of text pointed to by the link word.
  188.         The page of text may be within the main body of the text
  189.         or, starting with HyperRead version 5.5, it may be a
  190.         separate section of text that can only be accessed with a
  191.         Jump function. In either case, once you have
  192.         jumped to this new page, you can move normally through the
  193.         document using the <PgUp> and <PgDn> keys. You
  194.         also can jump to other areas of the document from there
  195.         using other link words. For example, suppose you jumped to
  196.         a page using the link word "Thomas Edison" and that page
  197.         contained the link word "light bulb." You could then jump
  198.         directly to the page pointed to by "light bulb."
  199.            If the link word is the name of a PCX picture file,
  200.         "jumping" to it displays that picture on the screen. For
  201.         example, moving the screen cursor to the word SATURN.PCX
  202.         and pressing the <J> key will display a sketch of Saturn.
  203.         Pressing any keyboard key (except control keys like Shift,
  204.         Ctrl, or Alt) or either mouse button will return you to the
  205.         document text.
  206.            If the link word is an executable file name with an EXE,
  207.         COM, or BAT extension, "jumping" to it will cause
  208.         HyperRead to run that program (assuming that it exists in
  209.         the current directory). For example, jumping from the word
  210.         NOTHING.COM will run the NOTHING.COM program. When the
  211.         program or batch file finishes running, HyperRead will
  212.         come back and display the page it was on before you ran the
  213.         program.
  214.  
  215.         Backtrack
  216.  
  217.            This function allows you to reverse the effects of the
  218.         Jump function. When you press the <B> key, the computer
  219.         will take you back to the page containing the most recently
  220.         used link word. For example, if you jumped to a destination
  221.         page using the link word "Thomas Edison," pressing the <B>
  222.         key would take you back to the page containing "Thomas
  223.         Edison."
  224.            You can use the backtrack function repeatedly. For
  225.         example, suppose you jumped to a page pointed to by "Thomas
  226.         Edison" and that page contained the link word "light bulb."
  227.         You then used the "light bulb" link word to jump to another
  228.         page. Pressing the <B> key twice would jump back to the
  229.         page containing "light bulb" and then to the page
  230.         containing "Thomas Edison." You can repeat this process
  231.         until you reach the page containing the first link word you
  232.         used.
  233.  
  234.         Search
  235.  
  236.            This option allows you to search the document for a
  237.         specific text string, such as a name. It is handy if you
  238.         want to find information on a subject, and there is no link
  239.         word on the screen that would take you to that subject.
  240.            When you pick this option, the computer will ask you for
  241.         the string of text to search for. Type the string and press
  242.         ENTER. If you have already used this option, the default
  243.         will be the last string you searched for. This allows you
  244.         to easily continue the search if you want more information
  245.         on the string.
  246.            The computer will always begin the search at the line
  247.         the screen cursor is on in the document. It does not find
  248.         any appearances of the string that occur before this in the
  249.         document.
  250.            The search is case-insensitive. That is, it disregards
  251.         capitalization. If you asked the computer to search for
  252.         "home," it would find "home," "Home," and "HOME."
  253.            The program searches each line of text for the search
  254.         string. It will not find the string if it is broken by the
  255.         end of a line. For example, if the string were "George
  256.         Washington," the program would not find it if the text
  257.         contained the word George on one line and Washington on the
  258.         next. For this reason, it is best if you limit your search
  259.         string to one word if possible.
  260.            When the program finds the search string, it displays
  261.         the page of text containing the string. The line containing
  262.         the string will be at the top of the screen. If the
  263.         document does not contain the string after the current
  264.         screen cursor position, the program will display a message
  265.         saying "String not found. Press space bar to continue."
  266.         When you press the space bar, the text will be at the same
  267.         point where you started the search.
  268.  
  269.         Print
  270.  
  271.            The Print function will send a copy of the document to
  272.         the printer. If the document contains page feed characters,
  273.         HyperRead will use those to format the document.
  274.         Otherwise, HyperRead will create its own formatting. It
  275.         will print out the document with margins at the top and
  276.         bottom of the page and a page number at the bottom of each
  277.         page.
  278.            To use this feature, set the printer at the top of a
  279.         page of formfeed paper, turn it on, and press the <P> key
  280.         on the keyboard. This is intended primarily for people who
  281.         are distributing HyperRead instructions for their Shareware
  282.         or public domain programs. This makes it unnecessary to
  283.         include a separate ASCII file of the instructions to print.
  284.  
  285.         Mouse Support
  286.  
  287.            If you have a mouse driver installed, HyperRead will
  288.         support the mouse. If you have a mouse driver installed,
  289.         you will have two cursors on the screen. One is controlled
  290.         by the mouse and one is controlled by the keyboard cursor
  291.         keys. The mouse cursor is somewhat darker in color. You
  292.         might need to move the mouse around a bit to help you find
  293.         the mouse cursor.
  294.            You can use the mouse to operate the HyperRead
  295.         navigation functions. Moving the mouse cursor to the word
  296.         PgUp at the bottom of the screen and pressing the left
  297.         mouse button (known as "clicking on it") has the same
  298.         effect as pressing the <PgUp> key. Clicking on PgUp with
  299.         the left mouse button has the same effect as <Ctrl-PgUp>.
  300.         Clicking on PgDn at the bottom of the screen with the left
  301.         mouse button has the same effect as pressing <PgDn>.
  302.         Clicking on it with the right mouse button has the same
  303.         effect as <Ctrl-PgDn>. Clicking on Home or End at the
  304.         bottom of the screen with either mouse button has the same
  305.         effect as pressing the <Home> or <End> buttons.
  306.            Clicking on a link word with the left mouse button
  307.         causes HyperRead to jump to the information referenced by
  308.         that link word, just as pressing the <J> key does. Pressing
  309.         the right mouse button causes HyperRead to backtrack
  310.         through the links just like pressing the <B> key does,
  311.         regardless of where the mouse cursor is located.
  312.            Other functions, such as Load, Quit, and Search, cannot
  313.         be controlled using the mouse. In some cases this is to
  314.         prevent you from accidentally activating the function (like
  315.         Quit) with the mouse. In other cases it is because the
  316.         function requires keyboard input anyway, such as the word
  317.         to search for.
  318.  
  319.                     Using HyperRead Generator
  320.  
  321.         Creating the text document
  322.  
  323.            HyperRead Generator creates the HyperRead control file
  324.         that allows HyperRead to read a HyperRead file. First,
  325.         you must create the document you want to convert to
  326.         hypertext on your own word processor or text editor. Almost
  327.         any word processor will do, provided it can create and save
  328.         a file with the following characteristics:
  329.  
  330.         1) The file must be saved in plain ASCII.
  331.         2) There must be a carriage return at the end of each line
  332.         3) Each line of the file must be less than 80 characters
  333.         long.
  334.         4) The document may contain page feed characters (ASCII
  335.         character 12) to force page feeds. However, it must not
  336.         contain tab characters (ASCII character 9). Convert any
  337.         such characters in your document to a series of spaces.
  338.         5) The lines of the document may not contain any embedded
  339.         line feeds other than those that accompany carriage returns.
  340.         6) The document may not contain any nonprinting characters,
  341.         such as bells or Esc characters. It may contain printable
  342.         ASCII characters, such as graphic characters (ASCII 129 and
  343.         above).
  344.         What all this really amounts to is that the document must
  345.         be pure ASCII. If your document does not satisfy these
  346.         requirements, HyperRead Generator will offer to convert it
  347.         to an acceptable format for you.
  348.            Starting with version 5.5 of HyperRead, you can divide
  349.         your ASCII document into sections of text. To separate
  350.         sections of text from each other, simple put the line 
  351.         ***END TEXT SECTION***
  352.         on a separate line at the end of a section of text. This
  353.         line must have the three asterisks, followed by the words
  354.         END TEXT SECTION in all capitals, and the three more asterisks
  355.         on the line exactly as shown, except that it must be the first
  356.         thing on the line, with no spaces before it. There must be
  357.         nothing else on the line, and no space before or after the
  358.         string of asterisks. Although the HyperRead Generator will
  359.         be able to move through the document freely with PgUp, PgDN,
  360.         and other normal movement keys, the HyperRead Reader will not
  361.         be able to move between sections except by using the Jump
  362.         and Backtrack functions. This system is ideal for
  363.         creating small footnotes, word definitions, short
  364.         explanations, and so on. At the end of the main body of your
  365.         text, you will be able to put a series of short sections and
  366.         link the main body of the text to these sections by hypertext
  367.         links. The reader can then read the main text, jump to the
  368.         clearly defined short sections, and return to the main text
  369.         using the backtrack key. They will not be able to 
  370.         accidentally scroll out of the area of the small link that you
  371.         intended for them to read. A typical document would be
  372.         formatted like this:
  373.  
  374.         Main body of text
  375.         ***END TEXT SECTION***
  376.         First short footnote, definition, etc.
  377.         ***END TEXT SECTION***
  378.         Second short footnote, definition, etc.
  379.         ***END TEXT SECTION***
  380.         Second short footnote, definition, etc.
  381.         ***END TEXT SECTION***
  382.         .
  383.         .
  384.         and so on. The final ***END TEXT SECTION*** after the last
  385.         block of text is optional, since the end of the text serves
  386.         as an automatic block.
  387.            If you divide your document into blocks of text like this,
  388.         the normal procedure is to create links from words or phrases
  389.         in the main body of the text to the first line of each short
  390.         section of text. (DO NOT create a link to the line that reads
  391.         ***END TEXT SECTION***.) This will allow the reader to jump
  392.         from the word or phrase in the main body, read the short
  393.         section, and then return to the main body. You can create
  394.         jumps from within one short section to another or even back to
  395.         the main body of the text if you want, but this will tend to
  396.         get complicated and defeat the purpose of dividing the text
  397.         up. The details of how to create jump links will be explained
  398.         shortly in the section that explains the Mark command.
  399.            Of course, this dividing of text into sections is entirely
  400.         optional. You can have just one block of text that the reader
  401.         can access through all scrolling techiniques and not include
  402.         the ***END TEXT SECTION*** marker at all in your document.
  403.  
  404.        Loading a file into HyperRead Generator
  405.  
  406.            When you run HyperRead Generator (HRG5.EXE) or select the
  407.         Load option, HyperRead Generator will give you three choices:
  408.         You can load a new text file, load an existing HyperRead 
  409.         document, or load an encoded text file. 
  410.            A new file would be an ASCII document that you have not 
  411.         yet created a HyperRead control file for. If you press 1, 
  412.         HyperRead Generator will display a directory of all documents 
  413.         in the correct directory and ask you which one to load. Type 
  414.         the full name and press ENTER. HyperRead Generator will then 
  415.         load the file.
  416.            If the file does not satisfy the requirements for a
  417.         HyperRead text file (for example, it contains lines that are
  418.         too long or has control characters), HyperRead Generator will
  419.         inform you of this and ask if you want it to convert the 
  420.         file. If you press Y, HyperRead Generator will save your 
  421.         original file with a BAK extension and convert the file. It
  422.         will then load the converted file. During the conversion,
  423.         HyperRead Generator will allow you set the left and right 
  424.         margins (expressed as a number of spaces for the document and 
  425.         choose how many spaces to replace a tab character with. The 
  426.         default is no margins and 3 spaces for tab characters.
  427.            The second type of file you can load into HyperRead 
  428.         Generator is an existing HyperRead file. This means a document
  429.         which you have already worked on and have a HyperRead control
  430.         file (the file with an HRF extension). If you press 3 when the 
  431.         program asks you what type of file to load, HyperRead 
  432.         Generator will display a list of HyperRead control files. Type 
  433.         the name of the file you want to load and press ENTER. You can 
  434.         then add new links to the old document.
  435.            The third type of file you can load into HyperRead 
  436.         Generator is an encoded text file. This is a file that 
  437.         HyperRead Generator will create at the same time as it creates 
  438.         the control file if you press Y when it asks if you want to
  439.         create an encoded text file. This is special file designed to 
  440.         allow you to edit the text of your document after you have 
  441.         created hypertext links in your text file. This will be 
  442.         explained later in this manual.
  443.  
  444.         Creating links with HyperRead Generator
  445.  
  446.            Once you have loaded a file, HyperRead Generator
  447.         operates very much like the HyperRead program. You load
  448.         and view files the same way as with HyperRead. HyperRead
  449.         Generator simply has several additional options that allow
  450.         you to create the link words and save the new document to
  451.         disk. The Print and Help HyperRead options are omitted
  452.         from HyperRead Generator. You do not need these options
  453.         with HyperRead Generator, anyway. You do no need the Help
  454.         option, since you can print out the manual using
  455.         HyperRead. You also can use your copy of HyperRead to
  456.         print the file, if you want to see how it looks printed out
  457.         by HyperRead.
  458.            The additional options for HyperRead Generator are Mark,
  459.         Unmark, and Disk. These options are explained below.
  460.  
  461.         Mark
  462.  
  463.            This is the option to create the HyperRead links that
  464.         allow the reader to jump from one part of the document to
  465.         another. You can create up to 2000 links in each document.
  466.         If you try to create more, the computer will just beep at
  467.         you.
  468.            To create a link, move the document with the <PgUp> and
  469.         <PgDn> keys so the word or phrase you want to turn into a
  470.         link phrase is on the screen. Then use the cursor keys to
  471.         move the screen cursor to the beginning of the word or
  472.         phrase. Press the <M> key. Use the right cursor key to move
  473.         the cursor to the end of the desired link word or phrase.
  474.         You will notice that the word becomes blue (or reverse
  475.         video with a monochrome display) as you move the cursor.
  476.         You can use the left cursor key to backtrack if you go too
  477.         far.
  478.            When you have marked the entire link word or phrase,
  479.         press the ENTER key. That ends the marking. Now move the
  480.         document to the part of the document that you want the link
  481.         word to point to (called the destination page). You can use
  482.         all the normal movement techniques, such as PgUp, PgDn,
  483.         Home, and End, to move within the document. You can even
  484.         use the Search or Jump options.
  485.            When you have found the beginning of the destination
  486.         page, move the screen cursor (with the cursor keys) to the
  487.         desired first line of the destination page. That is, the
  488.         line that you want to be at the top of the screen when the
  489.         user selects the link word. With the cursor on that line,
  490.         press the <M> key again. The link is now established. The
  491.         computer will then go back to the page with the link word.
  492.            You can abort the marking process at any time until you
  493.         have marked the destination page. Just press the <Esc> key
  494.         to abort marking.
  495.            The entire link word or phrase must be on one line. That
  496.         is, once you have marked the beginning of the link phrase
  497.         with the <M> key, you cannot move to the next line. Suppose
  498.         you want to mark a phrase that is split at the end of a
  499.         line. To do this, first mark the phrase up to the end of
  500.         the first line. Hit the ENTER key, go to the destination
  501.         page, and mark it with the <M> key just as you normally
  502.         would. Then go back to the link phrase, mark the rest of
  503.         the phrase starting at the beginning of the second line.
  504.         Point this link phrase at the same destination page. What
  505.         you are actually doing is creating two link phrases that
  506.         point at the same page. It will act, however, as if the
  507.         link phrase extended over several lines.
  508.            If you want to create a link to a PCX file so that
  509.         jumping from that link displays the file, simply include
  510.         the name of the file in your ASCII document. Then mark the
  511.         entire file name including the .PCX extension. After you have
  512.         marked the word and pressed ENTER, simply press M to link
  513.         the word to itself. If the link word ends in ".PCX", HyperRead
  514.         automatically assumes that it is a PCX file and tries to load 
  515.         it. For example, the file name SATURN.PCX has been included 
  516.         in this document and linked. Clicking on it with the left 
  517.         mouse button or pressing the <J> key while the screen cursor 
  518.         is on it will display the picture. If the program cannot find 
  519.         this PCX file, it will display an error message.
  520.            If you want to create a link to an EXE, COM, or batch file 
  521.         so HyperRead will run that program, simply put the name of the 
  522.         program in your ASCII text document. You must include the 
  523.         ".EXE", ".COM", or ".BAT" extension in the name. You may 
  524.         include command-line parameters. Mark the full name of the file 
  525.         (including command-line parameters) and link the word to 
  526.         itself. For example, NOTHING.COM has been marked in this 
  527.         document. If HyperRead cannot find the file when you try to 
  528.         jump to it, HyperRead will return to its original state with 
  529.         no error message.
  530.  
  531.         Unmark
  532.  
  533.            This function allows you to remove a link. Use the
  534.         keyboard cursor keys to move the screen cursor to the link
  535.         phrase you want to remove. Then press the <U> key. The
  536.         phrase will no longer be a link phrase.
  537.  
  538.         Disk
  539.  
  540.            Pressing the <D> key causes the program to save the
  541.         HyperRead control file on disk. If this is the first time
  542.         you have saved this file, HyperRead Generator saves the
  543.         file with the same name as the original ASCII text file,
  544.         but with the HRF extension replacing whatever extension
  545.         your ASCII file had. If you loaded a document that already
  546.         had a control file, HyperRead Generator will use the same
  547.         name the control file had when you loaded it. You should
  548.         always save the control file before ending the program if
  549.         you have made any changes in it (marked or unmarked any
  550.         link words).
  551.            After saving the HRF file, HyperRead Generator will ask
  552.         if you also want to save an encoded text file. You would
  553.         save this file only if you want to be able to edit the text
  554.         file later without destroying the hypertext links. This will
  555.         be explained later. Normally, you would press the <N> key to
  556.         indicate that you do not want to save this file. If you do
  557.         want to save this file, press the <Y> key.
  558.            HyperRead Generator does not modify the original ASCII
  559.         document file in any way. Only the control file (and
  560.         optionally the encoded text file) is changed or created.
  561.  
  562.         PCX graphics
  563.  
  564.            HyperRead and HyperRead Generator display PCX files in
  565.         three basic formats:
  566.  
  567.         1) 256 color PCX files. These are always displayed on a
  568.         320 X 200 pixel screen (screen mode 13).
  569.         2) PCX pictures of 16 colors or less having a height of
  570.         350 pixels or less. These are displayed on a 640 X 350
  571.         pixel screen (screen mode 9).
  572.         3) PCX pictures of 16 colors or less having a height of
  573.         more than 350 pixels. These are displayed on a 640 X 350
  574.         pixel screen (screen mode 12).
  575.  
  576.            Pictures that have more than 256 colors or are wider than
  577.         the screen they are displayed on (320 for 256 color pictures
  578.         or 640 for pictures with 16 or fewer colors) will appear as
  579.         hash on the screen. Pictures of 16 colors or less that are
  580.         taller than the display screen will be cut off at the bottom.
  581.         Pictures of 256 colors that are too tall will display the top
  582.         part of the picture, then overwrite this with the bottom part.
  583.         It is the responsibility of the person using HyperRead
  584.         Generator to test all pictures to be displayed by HyperRead to
  585.         make sure that they are in a format that works properly with
  586.         HyperRead.
  587.            Pictures that are narrower or shorter than the display
  588.         screen will simply not fill up the screen. For example, a 16
  589.         color 320 by 200 picture will appear in the upper left corner
  590.         of the screen. Pictures with less than 16 colors will be
  591.         displayed using whatever colors they have. Note: There are
  592.         several file formats for PCX pictures, and you may
  593.         occasionally get strange results from some of the less
  594.         common ones. The most common problem is that some PCX formats
  595.         do not contain color information. Such pictures may appear in
  596.         random colors, rather than the correct colors, when viewed
  597.         on HyperRead. This is most common with old black-and-white
  598.         PCX pictures. The picture will be visible, but the black and
  599.         white colors will be replaced by some random colors, like
  600.         red and purple.
  601.            In order to make it easier to create pictures for
  602.         HyperRead, there is a special PCX file called BLANK.PCX
  603.         provided with HyperRead Generator. This is a 16 color,
  604.         640 X 350 PCX picture of absolutely nothing. You can load
  605.         this PCX file into your paint program. This will automatically
  606.         configure the paint program to the proper settings for 16
  607.         color, 640 X 350 PCX files. You can then draw on the blank
  608.         screen. When you are finished, save the picture using
  609.         the Save As option and give the picture a different name.
  610.         If you do not change the name, you will overwrite the
  611.         BLANK.PCX file, making it harder to create pictures in the
  612.         future.
  613.            Note: Some paint programs, including Windows Paint,
  614.         create pictures that are slightly distorted (thinner) when
  615.         viewed by HyperRead. To compensate for this, you might
  616.         want to draw the pictures a little thicker horizontally
  617.         than you want them to appear on the screen. The pictures
  618.         will then look correct when displayed by HyperRead. You
  619.         might want to create a few sample pictures of circles and
  620.         squares and load these into HyperRead to check this out
  621.         before you create any elaborate pictures with your paint
  622.         program.
  623.  
  624.         Modifying HyperRead documents
  625.  
  626.            Once you have created a HyperRead control file for a
  627.         document, you should not change the ASCII text file. Doing
  628.         so can mess up your link pointers or cause other
  629.         undesirable results. In particular, any change that
  630.         decreases the total number of lines in the file will cause
  631.         HyperRead to crash when trying to load the file. If you
  632.         add lines, the new lines will not be read in when you load
  633.         the document into HyperRead. If you add lines in the
  634.         middle of a document, all links after the added lines will
  635.         be in the wrong places. Adding text in a line will cause
  636.         all links on that line after the added text to be wrong.
  637.            To make changes in the text of a document after you have
  638.         created links in the document, load your existing HyperRead
  639.         file into HyperRead Generator. Once the file is displayed on
  640.         the screen. Press the <D> key. When the program asks you if
  641.         you want to save an encoded text file also, press the <Y>
  642.         key. Then exit HyperRead Generator by pressing the <Q> key.
  643.            The encoded text file has the same name as your text file, 
  644.         but has the ETF extension. You can load this file into most
  645.         text editors. Simple text editors, such as the EDIT function
  646.         that comes with DOS 5.0 and above, generally work best. Some
  647.         fancier text editors may be confused by the control codes 
  648.         that HyperRead Generator embeds in the text.
  649.             The encoded text file will look much like your original
  650.         text file, except you will see some odd looking control
  651.         characters, like faces, houses, and foreign letters. When 
  652.         editing the encoded text file in your text editor you must
  653.         obey a few simple rules:
  654.         1) Throughout the file you will see many smiling faces of
  655.         various colors. Each face is followed by two other odd
  656.         looking characters, usually foreign letters or graphic 
  657.         characters. Do not delete or edit this string of three 
  658.         characters. You will also see some characters that look like 
  659.         little houses. Do not delete these either. Deleting the 
  660.         faces, the two characters after them, or the houses will 
  661.         destroy hypertext links. If you delete entire lines 
  662.         containing the characters, the links will automatically be 
  663.         deleted by HyperRead Generator.
  664.         Note: The faces and houses may look like boxes if you are
  665.         viewing the file in a Windows program, such as Windows Write.
  666.         The foreign characters may look different, too.
  667.         2) In editing the file, you should not create lines that are
  668.         too long (over 79 characters, not counting the faces or 
  669.         houses) for HyperRead generator. The same rules apply to this 
  670.         file as the original text files.
  671.            Once you have modified the encoded text file with your text
  672.         editor, save it as an ASCII text file. You may then run
  673.         HyperRead Generator and load the encoded text file (select 3
  674.         in the menu that lists types of files to load). When HyperRead
  675.         Generator loads the file, it will translate the code 
  676.         characters into HyperRead links and save a new control file
  677.         with an HRF extension. It will also create a new version of
  678.         the original text file that contains the text changes you made
  679.         in the encoded text file. Since this overwrites both the text
  680.         file and the control file, you might want to save these in
  681.         another directory just in case you want to go back to the
  682.         original file.
  683.            HyperRead Generator has considerable power to decipher the
  684.         changes you make in the encoded text file and create a new 
  685.         ASCII text file and HyperRead control file. On rare 
  686.         occassions, you may have changed the text file in such as way
  687.         that HyperRead Generator is unable to accept the new file. For
  688.         example, you may have created lines that are too long (over 79 
  689.         characters) or erased parts of links without erasing the whole
  690.         link. If this happens, HyperRead Generator will display an 
  691.         error message and terminate the program run, returning you to
  692.         DOS. The original ASCII text file and control file will not 
  693.         be altered. You may then go back to the encode text file and 
  694.         repair it. If some lines are too long, shorten them. It there 
  695.         are partially deleted links, erase the remaining link fragment
  696.         (usually one of the house characters) in the line indicated 
  697.         when HyperRead Generator terminated and try to load the ETF
  698.         again.
  699.             Once HyperRead Generator has loaded the encoded file, it
  700.         will display the file as it normally does. You can then add
  701.         or remove links from the file and save it, just as if you
  702.         had loaded the file from a control file (selection 3 in the
  703.         menu that lists types of files to load).
  704.  
  705.         Mouse support
  706.  
  707.            HyperRead Generator uses the mouse the same way as
  708.         HyperRead.
  709.  
  710.         System Requirements
  711.  
  712.            Both HyperRead and HyperRead Generator should run on
  713.         any IBM compatible computer with at least 256 K of memory.
  714.         The text portion of the document  will display on any
  715.         display system, even an old MDA card with a monochrome
  716.         display. To display the PCX files, you must have an EGA or
  717.         better graphic card. The Print option will work with any
  718.         type of printer, even a daisy-wheel.
  719.  
  720.         Distributing HyperRead Documents
  721.  
  722.           To distribute a HyperRead Document, you need to include
  723.         in the package the following items:
  724.  
  725.         1) Your original ASCII text file.
  726.         2) The HyperRead control file for that document with the
  727.         HRF extension.
  728.         3) The HyperRead program. This is a freeware program, so
  729.         you can distribute unlimited copies. It is suggested but
  730.         not required that you include the READER.DOC and READER.HRF
  731.         files with the program itself so the user can fully
  732.         understand the features of the reader. Otherwise, your
  733.         document itself should include reasonable instructions on
  734.         how to use HyperRead. At the very least, mention that the 
  735.         reader can get some instructions by pressing the <H> key.
  736.         4) Any PCX, COM, EXE, or BAT files that you have linked
  737.         with your document.
  738.  
  739.           Do not distribute the file with the ETF extension created
  740.         by HyperRead Generator. That is for your use only.
  741.  
  742.         Uses for HyperRead
  743.  
  744.            You can use this program to create any type of
  745.         easy-to-read document you like. For example, you can create
  746.         a HyperRead instruction manual. The users can quickly zero
  747.         in on any problems they have by using link words to go to
  748.         more and more specific descriptions of the problem. This
  749.         document is an example of such a file. Instruction manuals
  750.         for shareware programs are a particularly good use for
  751.         HyperRead.
  752.            HyperRead reference "books" can also be easy to use.
  753.         Consider a HyperRead cookbook. The first few pages of the
  754.         HyperRead file could be a list of recipes. The name of each
  755.         recipe could be a link word or phrase. The user could jump
  756.         directly to the recipe by pointing to it with the cursor
  757.         and pressing the <J> key. Within the recipes, some of the
  758.         more unusual ingredients could be link words. These links
  759.         could take the reader to a section at the end of the "book"
  760.         that gives information on the ingredients.
  761.            In a similar fashion, you could make each item in a
  762.         table of contents of any file a link phrase. The reader can
  763.         then jump directly to that page using the link phrase.
  764.            A more entertaining use of the HyperRead function is
  765.         interactive fiction. This is an increasingly popular form
  766.         of literature. In such a book, the reader does not read the
  767.         book from start to finish. Instead, the book offers the
  768.         reader choices on what to read. A typical story might say
  769.         something like, "If you want to explore the cave, turn to
  770.         page 38. If you want to continue on the path, go to the
  771.         next page." With HyperRead, you could have the reader
  772.         select which action to take by selecting the proper link
  773.         phrase. The program would then take the reader to the
  774.         proper page. This is similar to text adventure games.
  775.  
  776.         Registering HyperRead Generator
  777.  
  778.            HyperRead Generator is shareware. You are free to
  779.         experiment with it and create test documents for as long as
  780.         you like. However, before you may distribute any HyperRead
  781.         documents you create with HyperRead Generator, you are
  782.         required to register it by sending $25.00 to:
  783.  
  784.                       Leithauser Research
  785.                       4649 Van Kleeck Drive
  786.                       New Smyrna Beach, FL 32169
  787.  
  788.            This is a one-time fee. Once you have registered
  789.         HyperRead Generator, you may use it on one computer to
  790.         create as many HyperRead documents as you like without
  791.         paying any additional fees.
  792.  
  793.         Registering HyperRead Generator gives you several benefits:
  794.  
  795.         1) You can legally distribute documents created with
  796.            HyperRead Generator.
  797.         2) You will receive the latest version of HyperRead
  798.            Generator when you register.
  799.         3) You will automatically receive fixed versions of
  800.            HyperRead and HyperRead Generator if any bugs are
  801.            discovered.
  802.         4) You will receive announcements of major upgrades and
  803.            have the opportunity to receive these upgrades for
  804.            just $5 S&H.
  805.  
  806.         Bug reports, suggestions, questions, etc.
  807.  
  808.            If you have any questions about HyperRead or are
  809.         encountering any problems, you can write to Leithauser
  810.         Research at the above postal address. You can also reach
  811.         Leithauser Research at any of these EMAIL addresses:
  812.  
  813.         America Online: Leithauser
  814.             Compuserve:  74046,1556
  815.                  GEnie:  D.LEITHAUSER
  816.               Internet:  74046.1556@compuserve.com
  817.  
  818.            In extreme emergency, you can call (904)-423-0705
  819.         between the hours of 11 AM and 10 PM Eastern time.
  820.  
  821.         Custom software
  822.  
  823.            The primary function of Leithauser Research is
  824.         developing custom software to customer specifications. If
  825.         you need a program you cannot find anywhere, or you have an
  826.         idea for a program that you want to sell but do not have the
  827.         programming skilled to write the program yourself, contact
  828.         Leithauser Research at any of the above addresses (postal or
  829.         EMAIL) with a description of the program you have in mind
  830.         for a price quote. Prices are extremely reasonable. Unusual
  831.         and artificial intelligence programs are our speciality.
  832. ***END TEXT SECTION***
  833.            This is an example of a separate section of text that can
  834.         only be accessed by the Jump function of the HyperRead Reader.
  835.         Because these sections are intended to be small (and to reduce
  836.         the size of the HyperRead program), the Search and End options
  837.         are not implemented in text sections after the first section,
  838.         which is assumed to be the main body of text. However, scroll
  839.         up and down with the cursor keys, PgUp, PgDn, and Home
  840.         functions will work within these small sections of text if
  841.         they contain more than one screen of text.
  842.